FSPLIT

Section: User Commands (1)
Updated: 05 November 1989
Index Return to Main Contents

NAME

fsplit - split a multi-routine Fortran file into individual files

SYNOPSIS

fsplit [ -e efile ] ... [ file ]

DESCRIPTION

fsplit takes as input either a file or standard input containing Fortran source code. It attempts to split the input into separate routine files of the form name.f, where name is the name of the program unit (e.g. function, subroutine, block data or program).

Block data subprograms with no names get names of the form blkdtaNNN.f, where NNN is three digits and a file of this name does not already exist.

Main programs with no names get names of the form mainNNN.f .

If there is an error in classifying a program unit, or if name.f already exists, the program unit will be put in a file of the form zzzNNN.f where zzzNNN.f does not already exist.

Normally each subprogram unit is split into a separate file. For example:

        fsplit prog.f

will split each subprogram unit is split into a separate file.

When the -e option is used, only the specified subprogram units are split into separate files. For example:

        fsplit -e readit -e doit prog.f

will split readit and doit into separate files.

OPTIMIZER

At some levels the optimizer is file oriented. If the optimizer chokes, you might try fsplit on the source files. If each .f file is smaller, the optimizer has less to cope with.

DIAGNOSTICS

If names specified via the -e option are not found, a diagnostic is written to standard error.

HISTORY

The fsplit command appeared in BSD 4.1.

AUTHORS

Asa Romberger and Jerry Berkman

BUGS

fsplit assumes the subprogram name is on the first noncomment line of the subprogram unit. Nonstandard source formats may confuse fsplit.

It is hard to use -e for unnamed main programs and block data subprograms since you must predict the created file name.

This document was created by man2html, using the manual pages.
Time: 19:46:53 GMT, March 05, 2025